Antei’s tax platform maintains real-time accuracy through a robust and automated update system. Our approach ensures tax rate changes, jurisdiction-level rules, and compliance updates are handled in a structured, timely, and fully auditable manner — without manual intervention or business disruption.


How It Works

Every hour, a background sync job checks for new tax-related updates across supported countries and jurisdictions. These updates are queued, validated, and then automatically applied within the system — including country, jurisdiction, and county-level rules.


Update Structure

Each tax update is stored and processed based on a standardized structure:

FieldDescription
UpdateIDUnique identifier for the update event
ExecutionDateScheduled execution date (in UTC)
ExecutionTimeTimestamp (in ms) for when execution will occur
TimeZoneTimezone offset (in minutes) for the jurisdiction
TypeOfUpdateCreate New or Update Existing
TypeOfFieldField being modified — Standard Rate, Special Rate, or Additional Taxes
OldValueJSON object storing the previous value
NewValueJSON object storing the new value
ProductCategoriesList of internal category IDs affected by this update
ProductDeliveryMethodsDelivery method types affected (e.g., CLOUD, PHYSICAL)
CustomerTypeArray of customer types the rule applies to (e.g., B2B, B2C)
CountryIDInternal reference to the affected country
JurisdictionIDOne or more jurisdiction references affected
CountyIDOptional — applies if county-specific overrides exist

Execution Lifecycle

Each update follows a structured lifecycle:

StatusDescription
Not StartedUpdate is registered but not yet queued for execution
In ProcessThe update is currently being applied to the system
CompletedSuccessfully executed and reflected in live tax APIs
ErrorLogged for review if execution fails — retried automatically with backoff

We track StartTime, EndTime, and ProcessingTime to ensure transparency and operational monitoring.


Auditability & Governance

  • All updates are stored immutably with timestamps.
  • Audit logs record changes at the field level.
  • Failures are isolated and do not affect system availability.
  • Rollbacks are supported in the rare event of downstream impact.

Use Cases

  • Jurisdiction introduces a new digital services tax
  • Country increases standard VAT rate
  • Special tax holiday applied at county level
  • Regulatory notice affecting B2B exemptions

These updates are handled behind the scenes — no manual intervention or app downtime required.


Still Have Questions?

Reach out anytime at support@antei.com — we’re happy to assist with all types of queries.